home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / comm / ts_hp10e.zip / HOPA-ENG.EXE / HOMEPAGE.DOC
Text File  |  1996-08-24  |  11KB  |  276 lines
  1. * --------------------------------------------------------------------------- *
  2.  
  3.                             Twinsoft HOMEPAGER v1.0
  4.             (C)opyright 1996 Wolfgang Hommel, Twinsoft Development
  5.  
  6. * --------------------------------------------------------------------------- *
  7.  
  8.  
  9.  
  10.             Installation manual and program reference for the sysop
  11. ===============================================================================
  12.  
  13.  
  14. ! Important !
  15. -------------
  16.  
  17. This one is not a program for  your  coffee  break  ... if you want to use this
  18. powerful program, you must be ready to get in closer contact with it. It's  not
  19. one  of  these "Install & Forget" - PEXes! You should print out this manual and
  20. study it carefully. It will take more  than  5 minutes to understand how it all
  21. works, so if you hate "big" programs, leave better now ...
  22. But if you want to install a very powerful, attractive and fine-working program
  23. which will give much joy to you and your users, read on ;-)
  24.  
  25.  
  26. Introduction
  27. ------------
  28.  
  29. "Homepager" - what is this exactly? file_id.diz sound's great, but what  can  I
  30. do with it?
  31. You  should  know  the  name  "homepage" from WWW. There are e.g. big companies
  32. offering their homepages, e.g. to let  the visitors download new device drivers
  33. e.g. for their graphic cards. This big company - homepage can  be  compared  to
  34. our BBS. In our BBSs, too, we offer info texts, display (ansi) pictures and let
  35. the callers download some fine files.
  36. In  WWW  there  is  the  possibility  for  private persons, too, to create a own
  37. homepage, e.g. if company servers offer free space for private users, or if you
  38. are a member of AOL etc.
  39. What about user-homepages in our BBS?  not  much,  huh ? ;-) Some blackboards, a
  40. pinwall, that's all. No chance for users to integrate intro your BBS - at least
  41. no real chance.
  42. But now there is HOMEPAGER ... and this sweet little PEXie will  fill  the  gap
  43. between  WWW and BBSs! With homepager installed in your BBS, your users will be
  44. able to have their own homepages in your BBS! But there is more about it: there
  45. area file networks where these homepages can be distributed among other BBSs ..
  46. more about this later...
  47.  
  48. But what can users do with it ... it  has been tried (and it works :) ) to copy
  49. the functionality of WWW homepages (HPs) to BBS 1:1 ... this means:  there  can
  50. be  righteous menu structures (some nifty BBSs-in-your-BBS), they can offer own
  51. files for download, there are visitor  counters, guest books and scripts, links
  52. to other homepages and much much more. It's not HTML, it's ANSI, it's not  some
  53. web browser, it's a terminal program. Great atmosphere included ;-)
  54.  
  55. It's  what  many  sysops  have  been  dreaming of ... and this dream has become
  56. reality.
  57.  
  58.  
  59.  
  60. Shareware
  61. ---------
  62.  
  63. The Homepager is shareware at a price  of  20$  for a private BBS. I think this
  64. price is acceptable for such a powerful program. More info you will find in the
  65. order form in the REGISTER directory.
  66.  
  67. There are some good reasons to register, because in the unreg'd version:
  68.  
  69.     - you may not modify the ANSI pictures of the Homepager PEX itself
  70.     - you may not modify the user info package
  71.     - only 5 users can install their homepage in your system.
  72.  
  73. You may use this program for 30 days to check out whether you like it  or  not.
  74. After  30  days you have to register it or remove it from your system. Ask your
  75. users whether they are interested in  it  or  not, because in the first 30 days
  76. not too much users will like to upload their homepages. They get the user  info
  77. package  and then it takes about 2 weeks until a homepage gets uploaded, so get
  78. your user's opinion before removing the program!
  79.  
  80. Important: I cannot guarantee that his  program  will run on your system, and I
  81. cannot be made responsible for any errors  or  damages occuring while using  or
  82. abusing this program. Use it at your own risk!
  83. But: it works fine at hundrets of sites :-)
  84.  
  85.  
  86.  
  87. Installation
  88. ------------
  89.  
  90. Now the rave can go on :-) Please read the following instructions CAREFULLY, do
  91. EXACTLY  what  you should do and don't get frustrated if something doesn't work
  92. on first run.
  93.  
  94. Tip: if you got  to  specify  a  directory  somewhere  (e.g.  a  INI file, as a
  95. parameter for a .EXE) this directory name must  ALWAYS  be  terminated  with  a
  96. backslash  " \ " !!
  97.  
  98. First  of  all,  we  have  to create a BaseDir for homepager ... this must be a
  99. directory reserved only for homepager ...  give  it a short name, you will have
  100. to       type       it       often.       so,       do        not        create
  101. "c:\user1\communic.ate\mybbs\proboard\tools\pexes\misc\twinsoft\1996\homepage\"
  102. but name it D:\HP ... OK ? short name, directly below the ROOT ... great !
  103.  
  104. Then,  copy  all  files  from  this archive's PEX directory to your proboard pex
  105. directory e.g. c:\pb\pex ... and edit HOMEPAGE.INI ... i.e. set the right value
  106. for the  DIRECTORY  variable,  but  you  also  can  take  a  look  at the other
  107. variables, if you want :)
  108.  
  109. Next step, copy all files from archive \HP to your new created D:\HP  directory
  110. ... to the BaseDir !
  111.  
  112. Finally,   copy   all   files   from   archive   \txtfiles   to  your  proboard
  113. txtfiles-directory, e.g. c:\pb\txtfiles ...
  114.  
  115. The only thing left to do is  to  create  a  new menu hotkey in your BBS's main
  116. menu, using Procfg F9 ... there you create a new hotkey with
  117.  
  118.             Menufunction 60 - run SDK file
  119.                 Data: HOMEPAGE.PEX
  120.  
  121. (tip: if it doesn't work this way, try specifing
  122.  
  123.                 Data: HOMEPAGE
  124.  
  125. instead ! just leave the .PEX away ...)
  126.  
  127.  
  128. That's all ...
  129.  
  130.  
  131.  
  132. If you want to do more than that
  133. --------------------------------
  134.  
  135. ... then have a look at USER.EXE in the HP basedir, copy it to a temporary  dir
  136. and  execute  it  ...  this  is  the  user  info  package which you should read
  137. carefully and then you could install  the example homepage from this package in
  138. your BBS. Read in the user info what you got to compress and how, then get into
  139. your own BBS and upload your  homepage  the  way  described,  using  the  LOCAL
  140. PROTOCOL  which  is  distributed  with  Proboard.  If you do not have the local
  141. protocol,  you  will  have  to  call  your  own  BBS  from  remote  and  upload
  142. HOMEPAGE.ZIP and FILES.ZIP (see userinfo) ...
  143.  
  144. It would be even better if you  would create your real own homepage and install
  145. it in your system ... helps users very much, most of these are cowards who wait
  146. 'til another one does the first step... but then it goes round and round ;-)
  147.  
  148. After installing your (or the example) homepage, take a look at D:\HP  and  see
  149. how  situation  has  changed. Take a look at this dir from time to time and you
  150. will know how it all works.
  151.  
  152. If you run out of HDD  capacity  on  the  drive your Basedir lies, just try the
  153. following: move the homepage-subdirs (d:\hp\1 d:\hp\2 aso.)  to  another  drive
  154. and  edit  the  ascii  file index.hp, line 3 of every 5-line entry, and set the
  155. directory to the new drive. huuuuh ??? forget it, you will see ...
  156.  
  157.  
  158. Local utilites
  159. --------------
  160.  
  161. - Run them both from within your Basedir d:\hp !
  162.  
  163. hpbiglist: nice  filelist  generator  ...  very  detailed  list,  let the users
  164. download the generated list from somewhere in your BBS (homepager only offers a
  165. small overview list)
  166.  
  167. run it from within your basedir without parameters ... and then take a look  at
  168. HPBIGLST.TXT ... btw ... you should have some homepages before you do this ;-)
  169.  
  170.  
  171. Hpkiller  will remove unwanted user-own-files, e.g. porns, cracks, viruses etc.
  172. run from basedir, parameter: 1 filemask
  173.  
  174. e.g.           hpkiller.exe teen*.jpg
  175.  
  176.  
  177.  
  178. Network tools
  179. -------------
  180.  
  181. That's cool. Swap homepages round the world ... much better WWW feeling if your
  182. homepage can be visited from whereever the user is ...
  183.  
  184. Found / expand a regional file network  with  an area for homepages ... all you
  185. need is a file tosser/scanner like  FileScan,  Allfix,  MegaTic  ...  which  is
  186. capable of newfile-hatching.
  187.  
  188. Then, you will need two new directories:
  189.  
  190. d:\hp\inbound ... where your filetosser puts homepage-files from the net in
  191. d:\hp\outbound ... where your filetosser scans over and hatches new files from
  192.  
  193. To prepare your new homepages to be hatched, go to basedir and run
  194.  
  195.     hp2net.exe <pkzip> <target-dir\>
  196.  
  197. e.g. hp2net.exe c:\dos\pkzip.exe d:\hp\outbound\
  198.  
  199. (dunno forget the trailling \ ... !)
  200.  
  201. If  there are new sharable (see user info) homepages at your local system, this
  202. new homepage will be compressed and  named  as it's CRC-32 to avoid dupes, e.g.
  203. it is then named d:\hp\outbound\e32fa3c5.zip ... this file should be recognized
  204. by the filetosser's newfilehatch. yeah!
  205.  
  206.  
  207. To sort in the files that came from the net, use net2hp ... from basedir!
  208.  
  209. net2hp.exe <pkunzip> <inbound\> <basedir\>
  210.  
  211. e.g. net2hp.exe c:\dos\pkunzip.exe d:\hp\inbound\ d:\hp\
  212.  
  213. There is a automatic watch for dupes ... so ... no fear !
  214.  
  215.  
  216.  
  217. Hints
  218. -----
  219.  
  220. If it happens that Proboard says "Upload is a dupe -  deleted"  when  the  user
  221. uploads  FILES.ZIP  (see userinfo), you must remove all download-able FILES.???
  222. files from your system. I had this  problem,  in one of my file areas there was
  223. "files.bbs" downloable because it had a entry in my filelist (files.bbs, too).
  224.  
  225. So what I am trying to tell you: if you enter "FILES.*" when downloading  files
  226. in your file menu, no file must be found!
  227.  
  228. Another case: someone has upped a private file for you. Description is saved in
  229. FILES.PVT  ...  now there comes a file manager, finds this new file and adds it
  230. to your filebase, e.g. by writing  "files.pvt [00] (no desc)" to your files.bbs
  231. and then rebuilds the  Proboard  fileindex  (PBUTIL  FI).  Now  everyone  could
  232. download  FILES.PVT,  and  if  the  user  uploads  FILES.ZIP in homepager, this
  233. files.zip gets killed as dupe.
  234.  
  235. So again: remove all FILES.???  from  your  filebase ... this doesn't mean that
  236. you have to kill/rename all your FILES.BBS's !! These FILES.??? just may not be
  237. made downloadable.
  238.  
  239. Take a look into filesidx.pb and search there for "files." ... if you find one,
  240. you have forgotten one ... remove it and then rebuild the proboard index.
  241.  
  242. Great example: this is the listing file FILES.BBS of your area 10:
  243.  
  244. --------------------
  245. dummy1.zip   [00] (no desc)
  246. dummy2.zip   [00] (no desc)
  247. dummy3.zip   [00] (no desc)
  248. dummy4.zip   [00] (no desc)
  249. dummy5.zip   [00] (no desc)
  250. files.pvt    [00] automatically added file
  251. ---------------------
  252.  
  253. Then you just got to remove the FILES.PVT  entry  in  this  files.bbs  and  run
  254. PBUTIL  FI after you've done the same in all your areas (this is because I like
  255. using proboard's download function, there you can see areas where FILES.??? are
  256. left).
  257.  
  258.  
  259.  
  260. Support
  261. -------
  262.  
  263. Support is available for all registered  users.  Have a look at SUPPORT.SIT for
  264. more information.
  265.  
  266. If you are interested in this program and want to  register  it,  do  not  wait
  267. 'til the next version comes out: it will only run with a key, so you would have
  268. to register this version 1.0 anyway ... ;-)
  269.  
  270.  
  271.      Hope U enjoy it ...
  272.  
  273.                                 Wolfgang Hommel
  274.                       [ author of the Homepager program ]
  275.  
  276.